docs: complete authenticator and authorizer documentation#290
Open
GaneshPatil7517 wants to merge 9 commits intoapache:mainfrom
Open
docs: complete authenticator and authorizer documentation#290GaneshPatil7517 wants to merge 9 commits intoapache:mainfrom
GaneshPatil7517 wants to merge 9 commits intoapache:mainfrom
Conversation
- community.adoc: Update to use GitHub Discussions instead of Nabble - forums.adoc: Restructure and add GitHub Discussions section - issues.adoc: Update from Jira to GitHub Issues for issue tracking
GaneshPatil7517
force-pushed
the
docs-fill-authenticator-authorizer
branch
from
993f570 to
c911576
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
This PR completes the documentation for two core Apache Shiro components (Authenticator and Authorizer) that were previously marked as TODO placeholders. The documentation explains how these components fit into Shiro's architecture, their interaction with Realms, and configuration options. Additionally, the PR modernizes community support references by migrating from JIRA to GitHub Issues and adding GitHub Discussions.
Changes:
- Added comprehensive documentation for the Authenticator component, explaining its role in verifying user identity and coordinating with Realms during authentication
- Added comprehensive documentation for the Authorizer component, explaining its role in access control decisions and permission evaluation
- Updated community support pages to reference GitHub Issues instead of JIRA and added GitHub Discussions as a support channel
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| src/site/content/authenticator.adoc | Complete documentation replacing TODO placeholder, covering Authenticator's role, ModularRealmAuthenticator, authentication strategies, and Realm interaction |
| src/site/content/authorizer.adoc | Complete documentation replacing TODO placeholder, covering Authorizer's role, ModularRealmAuthorizer, permission/role checks, and multi-realm authorization |
| src/site/content/issues.adoc | Updated to reference GitHub Issues as the primary issue tracking system, with JIRA marked as legacy/archival |
| src/site/content/forums.adoc | Restructured to emphasize mailing lists per ASF guidelines and added GitHub Discussions as a community forum option |
| src/site/content/community.adoc | Updated forum and issue tracker references to GitHub Discussions and GitHub Issues |
| src/site/content/mailing-lists.adoc | Simplified reference from "Shiro Issues/JIRA List" to "Shiro Issues List" |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
lprimak
requested changes
Feb 9, 2026
Contributor
lprimak
left a comment
lprimak
left a comment
There was a problem hiding this comment.
Great job!
One change needed... the new guides are not linked anywhere on the site
Contributor
Author
|
ok ill work on that give me some time... |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR replaces placeholder TODO pages with complete documentation for the Authenticator and Authorizer components in Apache Shiro.
These are core Shiro components responsible for:
The documentation explains their roles in the SecurityManager architecture, how they coordinate with Realms, configuration options, and their purpose in the overall Shiro security framework.
Resolves #283